Automatically embeds a control in the smallest appropriate embedder control.

OSErr AutoEmbedControl (
    ControlRef inControl, 
    WindowRef inWindow
);

inControl

A handle to the control to be embedded.

inWindow

A pointer to the window in which to embed the control.

function result

A result code.

DISCUSSION

The Dialog Manager uses AutoEmbedControl to position dialog items in an embedding hierarchy based on both visual containment and the item list resource order. For more information on embedding hierarchies in dialog and alert boxes, see the function EmbedControl.

VERSION NOTES

This function is available with Appearance Manager 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)